RasDial Help Index

Properties	Methods	Events

RasDial Custom Control

Description:

DameWare RasDial ActiveX/OCX is a 32bit RAS (Remote Access Service) control for use with Visual Basic, Visual C++, web pages or any environment that can host the ActiveX controls.  It makes it easy for a application to dial-up a remote network do some work and disconnect. Easy to use with only few methods.

Registration:

How to register

Registration Form

What do I get when I register

License

Installation

Problems loading and using RasDial

Copyright

Versions


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.

<< If you wish to author help specific to each message box prompt, then remove the AFX_HIDP_xxx values from the [ALIAS] section of your .HPJ file, and author a topic for each AFX_HIDP_xxx value.  For example, AFX_HIDP_INVALID_FILENAME is the help topic for the Invalid Filename message box. >>


Registration Form
Order Form

RasDial Order Form  CAFRasDial20

___________________________________________________

To place your order, fax us at (504) 626-1189 or send this form to:

DAMEWARE DEVELOPMENT

1024 Live Oak Loop

Mandeville, La.  70448

Name:	________________________________________________________
Company Name:	________________________________________________________
Address:	________________________________________________________
	________________________________________________________
	________________________________________________________
	________________________________________________________
Phone:	Day time:_______________________Eve:______________________
Electronic Mail:	_________________________
RasDial	_____@ $19.95 ea	$________________________
Shipping and Handling	$ 3.00	$________________________
Total		$________________________
PLEASE NOTE: We accept cash, checks and money orders. We do not accept unsolicited POs or overseas checks not drawn on American banks.  Overseas orders please include an additional $5.00 USD for S & H.


How to register
How To Order

For added convenience, you may register RasDial in any of the following ways:

•	Visit our Web Site and order online with your Visa, MasterCard or Discover credit card at:  http://www.dameware.com/northstar.htm.

•	You may fax the form with your information to us at (504) 626-1189 or you may contact us at 504-626-7545.  (For quantity pricing, please contact DameWare Development.)  Or you may complete the order form and send it with a check or money order to:

DAMEWARE DEVELOPMENT

1024 Live Oak Loop

Mandeville, LA  70048


What do I get when I register
What do I get when I order

There are no limitations in this shareware release, but you may encounter a "nag" screen from time to time.  Upon receipt of your order you will receive a license file which will remove the “nag” screen. The product will be registered in your name and you will receive the latest version.  It's a small price to pay for your peace of mind. You may also wish to check on our Web Home Page for the latest version which you have rights to use as a registered user.  Our Web Home Page address is:  http://www.dameware.com.


Credit card orders
License Agreement

RasDial is not public domain or free software.

RasDial is copyrighted, and all rights are reserved by DameWare Development.

Licensing:

1. shareware version

You may use the shareware version of RasDial for up to 30 days in your design environment for evaluation purposes only. You may copy and distribute it freely as long as all the files in the package, including the demo programs are distributed with it and no changes or additions of any kind are made to the original package.

2. registered version

As a registered user, you can use RasDial in your design environment and you have a royalty-free right to distribute executables that use RasDial as a runtime component. Only registered users can distribute executables using RasDial.

You may copy the software to facilitate your use of it on as many computers as there are licensed users specified in the license file. Making copies for any other purpose violates international copyright laws. In particular, you are prohibited from distributing a registered version of RasDial, except as a runtime component of one of your applications.

The license file allows you to compile your applications with RasDial. You are not allowed to distribute the RasDial.LIC  or RasDial.LPK license files with any application that you distribute.

Disclaimer of Warranty:

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE SOLD "AS IS"  WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it.

The user must assume the entire risk of using the program.

Your use of this product indicates that you have read and agreed to these terms.


Credit card orders
Installation

DameWare RasDial is distributed with a self-extracting installation wizard file - RasDialW.exe.  Once executed, RasDialW.exe will install the RasDial components into a directory of your choosing (c:\Program Files\DameWare\RasDial\ by default), and register the RasDial.ocx component into the Windows system registry.

The following is a list of the files installed during the installation wizard process:

RasDial.OCX	32-bit ActiveX OCX Control

RasDial.HLP	On-line documentation

RasDial.CNT	Contents file for On-line documentation

RasDial.EXE	RasDial VB sample executable

RasDial.FRM	RasDial VB sample form

RasDial.VBP	RasDial VB sample project file

Once you have registered the RasDial component, you will receive the following license files:

RasDial.LIC	License file (if you have a registered version)

RasDial.LPK	License file for web pages (if you have a registered version)

Distribution Note:

When you create and distribute applications that use RasDial, you can install the appropriate file in the customer's Microsoft Windows \SYSTEM subdirectory, or any specific directory as long as the component is registered to that subdirectory.

Note: You are not allowed to distribute the RasDial.LIC or RasDial.lpk license files with any application that you distribute.


Problems using the control
Problems

Problems loading and using this OCX:

The most common problems using OCXs built with Microsoft’s Visual C++ 4.0 or greater are  incorrect versions of some of the VB4 runtime libs. PSS ( Microsoft Premier Support Service) has confirmed this to be a problem.  This only affects controls linked with the newer version of these libraries.

The libraries in question are listed in the VB4 SWDEPEND.INI:

MFC40.DLL 	version 4.0.5277

OLEPRO32.DLL	version 4.0.5277

MSVCRT40.DLL	version 4.00.5277

The libraries shipped with Visual Basic 4.0 are dated 8/95. At this time, the known good libraries are dated 9/95 and 2/96.

These libraries can be obtained many ways such as on the VB conference on CompuServe and also on our web site at http://www.dameware.com.


Displays version of NetList.OCX, NetList help
Version

RasDial Version 1,2,0,4 - RasDial.OCX

RasDial Help Version 2.0 - RasDial.HLP


Displays appropriate Copyright notices
Copyright

Copyright© 1996-1998 DameWare Development

Portions of this product are Copyrighted (c) 1991-1998 by Microsoft Corporation.

All rights are reserved. All  Microsoft Corporation disclaimers apply.

RasDial is a trademark of DameWare Development.

Microsoft Windows is a registered trademark of Microsoft Corporation.


Displays Properties
Properties

All the properties are listed below. Properties that apply only to

RasDial, or require special consideration when used with it,

are underlined. They are documented in this help file. See the

Visual Basic Language Reference or online Help for

documentation of the remaining properties.

(About)
Caption
	DragIcon
DragMode	Enabled
	Font
Height	HelpContextId
Hwnd	Index
Left	MouseIcon
MousePointer	Parent
	TabIndex
TabStop	Tag
Top	Visible
Width


Displays Methods
Methods

All of the methods are listed below. Methods that apply only to

RasDial, or require special consideration when used

with it, are underlined. They are documented in this help file.

See the Visual Basic Language Reference or online Help for

documentation of the remaining events.

About

RasConnect

RasConnectUser

IsConnected

RasDialConfig

RasShutDown

GetIPAddress

Move

SetFocus

Refresh


RAS Connect
 RasConnect Method

Properties	Methods	Events

Description

RasConnect Dials the specified RAS entry or if empty brings up a phone book dialog.

Syntax

RasDial1.RasConnect [ long, string, {True | False})

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

n% = RasDial1.RasConnect(Form1.hWnd, "CompuServe", False)

End Sub

See Also


RAS Connect User
 RasConnectUser Method

Properties	Methods	Events

Description

RasConnect Dials the specified RAS entry, User Name, Password and Domain.

Syntax

RasDial1.RasConnectUser [ long, string, string, string, string)

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

n% = RasDial1.RasConnectUser(Form1.hWnd, "CompuServe", “Ken”, “Password”, “Domain”)

End Sub

See Also

Notes

Domain Specifies a string containing the domain on which authentication is to occur. An empty string ("") specifies the domain in which the remote access server is a member. An asterisk specifies the domain stored in the phonebook for the entry.


Check Connection Status
 IsConnected Method

Properties	Methods	Events

Description

IsConnected Check the connection status.

Syntax

RasDial1.IsConnected

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

if RasDial1.IsConnected Then

Text1.Text = Connected

End If

End Sub

See Also

Notes


Phone Book
 RasDialConfig Method

Properties	Methods	Events

Description

RasDialConfig Brings up a phone book dialog.

Syntax

RasDial1.RasDialConfig  [ long ]

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

RasDial1.RasDialConfig (Form1.hWnd)

End Sub

See Also


Shut Down
 RasShutDown Method

Properties	Methods	Events

Description

RasShutDown  Disconnect the current RAS session.

Syntax

RasDial1.RasShutDown

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

 RasDial1.RasShutDown

End Sub

See Also


Get IP Address
 GetIPAddress Method

Properties	Methods	Events

Description

GetIPAddress Returns the IP Address for the current session.

Note:

May return an empty string

Syntax

RasDial1.GetIPAddress

Data Type

Integer (Boolean)

Example

Private Sub Command1_Click()

n = RasDial1.RasConnect(Form1.hWnd, "", False)

If n = True Then

Text1.Text = RasDial1.GetIPAddress()

End If

End Sub

See Also


Displays Events
Events

All the events are listed below. Events that apply only to

RasDial, or require special consideration when used

with it, are underlined. They are documented in this help file.

See the Visual Basic Language Reference or online Help for

documentation of the remaining events.

Click

DblClick

DragDrop

DragOver

GotFocus

KeyDown

KeyPress

KeyUp

LostFocus

MouseDown

MouseMove

MouseUp